urlProgress

Type

message

Summary

Sent when updates on ongoing url requests are communicated.

Syntax

urlProgress <pUrl>, <pStatus>, [<pMessage>, [<pBytesTotal>]]

Description

Sent when updates on ongoing url requests are communicated. This message is periodically sent to the object whose script initiated the operation.

warning

The urlProgress message is not part of the libUrl or tsNet libraries. It is instead implemented in the mobile engine, whose network-related functionality can not be used together with those libraries in a standalone. Adding either of the "Internet" or "tsNet" Inclusions will result in them overriding/replacing any network-related functionality that is implemented in the mobile engine, including the urlProgress message. To use the urlProgress message in a mobile standalone, ensure that the "Internet" and "tsNet" Inclusions are not added in the standalone settings.

Parameters

Name	Type	Description
pUrl		The name of the url for which a message is being sent.
pStatus	enum	The type of update message being sent
pMessage	enum	A message sent with some of the status parameters
pBytesTotal		Empty if the web server does not send the total data size.

Examples

on urlProgress pUrl, pStatus
   if pStatus is "downloaded" then
      answer "Finished downloading" with "Okay"
   end if
end urlProgress

on urlProgress pUrl, pStatus, pMessage
   if pStatus is "error" then
      answer "Encountered Error:" && pMessage with "Okay"
   end if
end urlProgress

Related

command: put, post, load

glossary: message

Compatibility and Support

Introduced

LiveCode 4.6.1

OS

ios

android

web

Platforms

mobile

desktop